home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / extnp100.zip / EXTRNETP.DOC < prev    next >
Text File  |  1995-02-12  |  5KB  |  113 lines
  1.  
  2.                                   EXTRNETP
  3.                                 Version 1.00
  4.             Copyright (c) Bob Swift, 1995.  All Rights Reserved.
  5.                    Compiled with the Watcom C/C++ compiler.
  6.  
  7.    This program is designed to read an input nodelist file and extract
  8.    selected Networks, Regions and/or Zones.  The extracted portions of
  9.    the nodelist are stored in a file specified on the command line.
  10.  
  11.    The format for using this program is as follows:
  12.  
  13.  
  14.         EXTRNETP <srcfile> <destfile> [I] <net1> <net2>...<net20>
  15.  
  16.    where <srcfile>    is the name of the nodelist file to be read
  17.          <destfile>   is the name of the output file created
  18.          [I]          optionally include all Zone entries
  19.          <net..>      are the numbers of the Net/Region/Zones to be extracted
  20.                       and may include zone specifiers for Nets and Regions
  21.                       (the program is presently set to handle 20 numbers).
  22.                       These numbers may be preceded by a N, R or Z in order
  23.                       to extract the entire Net, Region or Zone.  Examples
  24.                       are: 123 N342 n2:201 r17 Z1
  25.  
  26.  
  27.    The nodelist may be specified with a full drive and path.  The destination
  28.    file must not have a drive or path specified.  It will be output to the
  29.    current directory.
  30.  
  31.    The inclusion of Zone lines is controlled in two ways and they operate
  32.    differently.  The first way is to use the optional 'I' parameter, which
  33.    will include all Zone lines in the nodelist.  The other way is to use a
  34.    zone-specifier with the search criteria.  This will only include those
  35.    Zone lines which are specified in the search criteria.  For example, if
  36.    your command line looks like this:
  37.  
  38.         extrnetp nodelist.123 net-342.123 i n342
  39.  
  40.    the output would include all Zone listings as well as all of the entries
  41.    in Net 342 in every zone where Net 342 appears.  If the command line is
  42.    modified as:
  43.  
  44.         extrnetp nodelist.123 net-342.123 n342
  45.  
  46.    the output would not include any Zone listings but would include all of
  47.    the entries in Net 342 in every zone where Net 342 appears.  If the
  48.    command line is further modified as:
  49.  
  50.         extrnetp nodelist.123 net-342.123 n1:342
  51.  
  52.    the output would not include any Zone listings except Zone 1, and would
  53.    include all of the entries for Net 342 in Zone 1.  Note that use of the
  54.    'I' parameter will always result in the inclusion of all Zone lines.
  55.  
  56.    The program will display a VERY brief set of instructions if it is called
  57.    without any arguments or if it encounters an error.  The following is a
  58.    list of the error codes returned by the program:
  59.  
  60.                   0 - No errors.  Normal termination.
  61.                   1 - Bad or missing command line argument.
  62.                   2 - Unable to open the input file.
  63.                   3 - Unable to open the output file.
  64.                   4 - Problem writing to output file.
  65.                   5 - Problem closing input file.
  66.                   6 - Problem closing output file.
  67.                   7 - Unable to open configuration file.
  68.                   8 - Unable to create backup file.
  69.  
  70.    When an error is encountered, the program will exit immediately and will
  71.    attempt to properly close all files.
  72.  
  73.    Although I have chosen to retain all rights to this program, you are free
  74.    to use it under the following conditions:
  75.  
  76.             - You realize that there is NO Warrantee of any sort.
  77.               It was tested pretty thoroughly here before release
  78.               but who knows what bugs may be lurking within.
  79.  
  80.             - You will not modify the code and release a new version
  81.               of the program.  I welcome suggestions for improvement
  82.               (especially when accompanied by code) but I make no
  83.               guarantee of future releases.
  84.  
  85.             - If you find the program useful, send me a postcard.
  86.               My address is:
  87.  
  88.                     Bob Swift
  89.                     5708 - 47th Street
  90.                     Stony Plain, Alberta
  91.                     Canada, T7Z 1C6
  92.  
  93.               This way I get an idea of who is using the program,
  94.               and who I should notify when a new version is released.
  95.  
  96.  
  97.    You may freely distribute this program provided that you distribute only
  98.    the complete archive which includes the EXTRNETP.EXE, EXTRNETP.C,
  99.    EXTRNETP.DOC, and FILES_ID.DIZ.  Please do not "re-package" the archive
  100.    because it will lose the ZIP security envelope.  Thanks.
  101.  
  102.                                                    Bob Swift
  103.                                                (1:342/5@fidonet)
  104.  
  105.  
  106.  
  107.    Revision History
  108.    ----------------
  109.  
  110.    1.00     95/02/12    First release version.
  111.  
  112.  
  113.